Pattern per gli Hook di React: Padroneggiare lo Sviluppo di Hook Personalizzati per Applicazioni Globali

            
import React, { useState, useCallback } from 'react';

/**
 * Un hook personalizzato per gestire un contatore numerico.
 * @param {number} initialValue - Il valore iniziale del contatore. Predefinito a 0.
 * @returns {{ count: number, increment: () => void, decrement: () => void, reset: () => void }}
 */
function useCounter(initialValue = 0) {
  const [count, setCount] = useState(initialValue);

  const increment = useCallback(() => {
    setCount(prevCount => prevCount + 1);
  }, []); // Nessuna dipendenza, poiché setCount è stabile

  const decrement = useCallback(() => {
    setCount(prevCount => prevCount - 1);
  }, []); // Nessuna dipendenza

  const reset = useCallback(() => {
    setCount(initialValue);
  }, [initialValue]); // Dipende da initialValue

  return {
    count,
    increment,
    decrement,
    reset
  };
}

export default useCounter;

            

              
                Copy
              
            
          

            
import React from 'react';
import useCounter from './useCounter'; // Supponendo che useCounter.js sia nella stessa directory

function CounterComponent() {
  const { count, increment, decrement, reset } = useCounter(10);

  return (
    <div>
      <h3>Conteggio Corrente: {count}</h3>
      <button onClick={increment}>Incrementa</button>
      <button onClick={decrement}>Decrementa</button>
      <button onClick={reset}>Resetta</button>
    </div>
  );
}

export default CounterComponent;

            

              
                Copy
              
            
          

            
import React, { useState, useEffect, useCallback } from 'react';

/**
 * Un hook personalizzato per recuperare dati da un'API.
 * @param {string} url - L'URL da cui recuperare i dati.
 * @param {object} options - Opzioni di fetch (es. headers, method, body).
 * @returns {{ data: any, loading: boolean, error: Error | null, refetch: () => void }}
 */
function useFetch(url, options = {}) {
  const [data, setData] = useState(null);
  const [loading, setLoading] = useState(true);
  const [error, setError] = useState(null);

  const fetchData = useCallback(async () => {
    setLoading(true);
    setError(null);
    try {
      const response = await fetch(url, options);
      if (!response.ok) {
        throw new Error(`Errore HTTP! stato: ${response.status}`);
      }
      const result = await response.json();
      setData(result);
    } catch (err) {
      setError(err);
    } finally {
      setLoading(false);
    }
  }, [url, JSON.stringify(options)]); // Stringify delle opzioni per un confronto profondo

  useEffect(() => {
    fetchData();
  }, [fetchData]);

  return { data, loading, error, refetch: fetchData };
}

export default useFetch;

            

              
                Copy
              
            
          

            
import React from 'react';
import useFetch from './useFetch';

function UserProfile({ userId }) {
  const { data: user, loading, error } = useFetch(`https://api.example.com/users/${userId}`);

  if (loading) return <p>Caricamento profilo utente...</p>;
  if (error) return <p style={{ color: 'red' }}>Errore: {error.message}</p>;
  if (!user) return <p>Nessun dato utente trovato.</p>;

  return (
    <div>
      <h2>{user.name}</h2>
      <p>Email: {user.email}</p>
      <p>Località: {user.location}</p>
      <!-- Altri dettagli utente -->
    </div>
  );
}

export default UserProfile;

            

              
                Copy
              
            
          

            
import React, { useState, useEffect } from 'react';

/**
 * Un hook personalizzato per rendere persistente lo stato nel localStorage.
 * @param {string} key - La chiave per il localStorage.
 * @param {any} initialValue - Il valore iniziale se non vengono trovati dati nel localStorage.
 * @returns {[any, (value: any) => void]}
 */
function useLocalStorage(key, initialValue) {
  // Stato per memorizzare il nostro valore
  // Passa la funzione di stato iniziale a useState in modo che la logica venga eseguita solo una volta
  const [storedValue, setStoredValue] = useState(() => {
    try {
      const item = typeof window !== 'undefined' ? window.localStorage.getItem(key) : null;
      return item ? JSON.parse(item) : initialValue;
    } catch (error) {
      console.error(`Errore durante la lettura della chiave localStorage "${key}":`, error);
      return initialValue;
    }
  });

  // useEffect per aggiornare il localStorage quando lo stato cambia
  useEffect(() => {
    try {
      if (typeof window !== 'undefined') {
        window.localStorage.setItem(key, JSON.stringify(storedValue));
      }
    } catch (error) {
      console.error(`Errore durante la scrittura sulla chiave localStorage "${key}":`, error);
    }
  }, [key, storedValue]);

  return [storedValue, setStoredValue];
}

export default useLocalStorage;

            

              
                Copy
              
            
          

            
import React from 'react';
import useLocalStorage from './useLocalStorage';

function ThemeSwitcher() {
  const [isDarkMode, setIsDarkMode] = useLocalStorage('theme-preference', false);

  const toggleTheme = () => {
    setIsDarkMode(prevMode => !prevMode);
    document.body.className = isDarkMode ? '' : 'dark-theme'; // Applica la classe CSS
  };

  return (
    <div>
      <p>Tema Corrente: {isDarkMode ? '<strong>Scuro</strong>' : '<strong>Chiaro</strong>'}</p>
      <button onClick={toggleTheme}>
        Passa al Tema {isDarkMode ? 'Chiaro' : 'Scuro'}
      </button>
    </div>
  );
}

export default ThemeSwitcher;

            

              
                Copy
              
            
          

            
import { useState, useCallback } from 'react';

/**
 * Un hook personalizzato per gestire uno stato booleano.
 * @param {boolean} initialValue - Il valore booleano iniziale. Predefinito a false.
 * @returns {[boolean, () => void, (value: boolean) => void]}
 */
function useToggle(initialValue = false) {
  const [value, setValue] = useState(initialValue);

  const toggle = useCallback(() => {
    setValue(prev => !prev);
  }, []);

  return [value, toggle, setValue];
}

export default useToggle;

            

              
                Copy
              
            
          

            
import React from 'react';
import useToggle from './useToggle';

function ModalComponent() {
  const [isOpen, toggleOpen] = useToggle(false);

  return (
    <div>
      <button onClick={toggleOpen}>Mostra/Nascondi Modale</button>
      {isOpen && (
        <div style={{
          border: '1px solid black', 
          padding: '20px', 
          margin: '10px', 
          backgroundColor: 'lightblue'
        }}>
          <h3>Questa è una Modale</h3>
          <p>Il contenuto va qui.</p>
          <button onClick={toggleOpen}>Chiudi Modale</button>
        </div>
      )}
    </div>
  );
}

export default ModalComponent;

            

              
                Copy
              
            
          

            
import { useEffect, useRef } from 'react';

/**
 * Un hook personalizzato per aggiungere e pulire gli event listener.
 * @param {string} eventName - Il nome dell'evento (es. 'click', 'resize').
 * @param {function} handler - La funzione di gestione dell'evento.
 * @param {EventTarget} element - L'elemento del DOM a cui associare il listener. Predefinito a window.
 * @param {object} options - Opzioni dell'event listener (es. { capture: true }).
 */
function useEventListener(eventName, handler, element = window, options = {}) {
  // Crea un ref che memorizza l'handler
  const savedHandler = useRef();

  // Aggiorna il valore di ref.current se l'handler cambia. Ciò consente all'effetto sottostante
  // di utilizzare sempre l'handler più recente senza dover ri-associare l'event listener.
  useEffect(() => {
    savedHandler.current = handler;
  }, [handler]);

  useEffect(() => {
    // Assicurati che l'elemento supporti addEventListener
    const isSupported = element && element.addEventListener;
    if (!isSupported) return;

    // Crea un event listener che chiama savedHandler.current
    const eventListener = event => savedHandler.current(event);

    // Aggiungi l'event listener
    element.addEventListener(eventName, eventListener, options);

    // Pulisci allo smontaggio o quando le dipendenze cambiano
    return () => {
      element.removeEventListener(eventName, eventListener, options);
    };
  }, [eventName, element, options]); // Esegui di nuovo se eventName o element cambiano
}

export default useEventListener;

            

              
                Copy
              
            
          

            
import React, { useState } from 'react';
import useEventListener from './useEventListener';

function KeyPressDetector() {
  const [key, setKey] = useState('Nessuno');

  const handleKeyPress = (event) => {
    setKey(event.key);
  };

  useEventListener('keydown', handleKeyPress);

  return (
    <div>
      <p>Premi un tasto qualsiasi per vederne il nome:</p>
      <strong>Ultimo Tasto Premuto: {key}</strong>
    </div>
  );
}

export default KeyPressDetector;

            

              
                Copy
              
            
          

            
import { useState, useCallback } from 'react';

/**
 * Un hook personalizzato per gestire lo stato di un modulo e i cambiamenti degli input.
 * @param {object} initialValues - Un oggetto con i valori iniziali dei campi del modulo.
 * @param {object} validationRules - Un oggetto con funzioni di validazione per ogni campo.
 * @returns {{ values: object, errors: object, handleChange: (e: React.ChangeEvent) => void, handleSubmit: (callback: (values: object) => void) => (e: React.FormEvent) => void, resetForm: () => void }}
 */
function useForm(initialValues, validationRules = {}) {
  const [values, setValues] = useState(initialValues);
  const [errors, setErrors] = useState({});

  const handleChange = useCallback((event) => {
    event.persist(); // Rendi persistente l'evento per usarlo in modo asincrono (se necessario)
    const { name, value, type, checked } = event.target;

    setValues((prevValues) => ({
      ...prevValues,
      [name]: type === 'checkbox' ? checked : value,
    }));

    // Pulisci l'errore per il campo non appena viene modificato
    if (errors[name]) {
      setErrors((prevErrors) => {
        const newErrors = { ...prevErrors };
        delete newErrors[name];
        return newErrors;
      });
    }
  }, [errors]);

  const validate = useCallback(() => {
    const newErrors = {};
    for (const fieldName in validationRules) {
      if (validationRules.hasOwnProperty(fieldName)) {
        const rule = validationRules[fieldName];
        const value = values[fieldName];
        if (rule && !rule(value)) {
          newErrors[fieldName] = `${fieldName} non valido`;
          // In un'app reale, forniresti messaggi di errore specifici basati sulla regola
        }
      }
    }
    setErrors(newErrors);
    return Object.keys(newErrors).length === 0;
  }, [values, validationRules]);

  const handleSubmit = useCallback((callback) => (event) => {
    event.preventDefault();
    const isValid = validate();
    if (isValid) {
      callback(values);
    }
  }, [values, validate]);

  const resetForm = useCallback(() => {
    setValues(initialValues);
    setErrors({});
  }, [initialValues]);

  return {
    values,
    errors,
    handleChange,
    handleSubmit,
    resetForm,
  };
}

export default useForm;

            

              
                Copy
              
            
          

            
import React from 'react';
import useForm from './useForm';

const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;

function LoginForm() {
  const { values, errors, handleChange, handleSubmit } = useForm(
    { email: '', password: '' },
    {
      email: (value) => emailRegex.test(value) && value.length > 0,
      password: (value) => value.length >= 6,
    }
  );

  const submitLogin = (formData) => {
    alert(`Invio in corso: Email: ${formData.email}, Password: ${formData.password}`);
    // In un'app reale, invia i dati a un'API
  };

  return (
    <form onSubmit={handleSubmit(submitLogin)}>
      <h2>Login</h2>
      <div>
        <label htmlFor="email">Email:</label>
        <input
          type="email"
          id="email"
          name="email"
          value={values.email}
          onChange={handleChange}
        />
        {errors.email && <p style={{ color: 'red' }}>{errors.email}</p>}
      </div>
      <div>
        <label htmlFor="password">Password:</label>
        <input
          type="password"
          id="password"
          name="password"
          value={values.password}
          onChange={handleChange}
        />
        {errors.password && <p style={{ color: 'red' }}>{errors.password}</p>}
      </div>
      <button type="submit">Accedi</button>
    </form>
  );
}

export default LoginForm;

            

              
                Copy
              
            
          

            
// AuthContext.js
import React, { createContext, useContext, useState, useEffect, useCallback } from 'react';

const AuthContext = createContext(null);

// Hook personalizzato per la logica di autenticazione
export function useAuth() {
  const [user, setUser] = useState(null);
  const [isLoading, setIsLoading] = useState(true);

  // Simula una funzione di login asincrona
  const login = useCallback(async (username, password) => {
    setIsLoading(true);
    return new Promise(resolve => {
      setTimeout(() => {
        if (username === 'test' && password === 'password') {
          const userData = { id: '123', name: 'Utente Globale' };
          setUser(userData);
          localStorage.setItem('user', JSON.stringify(userData));
          resolve(true);
        } else {
          resolve(false);
        }
        setIsLoading(false);
      }, 1000);
    });
  }, []);

  // Simula una funzione di logout asincrona
  const logout = useCallback(() => {
    setUser(null);
    localStorage.removeItem('user');
  }, []);

  // Carica l'utente dal localStorage al montaggio
  useEffect(() => {
    const storedUser = localStorage.getItem('user');
    if (storedUser) {
      try {
        setUser(JSON.parse(storedUser));
      } catch (e) {
        console.error('Impossibile analizzare l'utente dal localStorage', e);
        localStorage.removeItem('user');
      }
    }
    setIsLoading(false);
  }, []);

  return { user, isLoading, login, logout };
}

// Componente AuthProvider per avvolgere la tua applicazione o parti di essa
export function AuthProvider({ children }) {
  const auth = useAuth(); // Qui viene utilizzato il nostro hook personalizzato

  return (
    <AuthContext.Provider value={auth}>
      {children}
    </AuthContext.Provider>
  );
}

// Hook personalizzato per consumare AuthContext
export function useAuthContext() {
  const context = useContext(AuthContext);
  if (context === undefined) {
    throw new Error('useAuthContext deve essere usato all'interno di un AuthProvider');
  }
  return context;
}

            

              
                Copy
              
            
          

            
// App.js (o componente radice)
import React from 'react';
import { AuthProvider, useAuthContext } from './AuthContext';

function Dashboard() {
  const { user, isLoading, logout } = useAuthContext();

  if (isLoading) return <p>Caricamento stato autenticazione...</p>;
  if (!user) return <p>Per favore, accedi.</p>;

  return (
    <div>
      <h2>Benvenuto, {user.name}!</h2>
      <button onClick={logout}>Logout</button>
    </div>
  );
}

function LoginFormForContext() {
  const { login } = useAuthContext();
  const [username, setUsername] = useState('');
  const [password, setPassword] = useState('');

  const handleLogin = async (e) => {
    e.preventDefault();
    const success = await login(username, password);
    if (!success) {
      alert('Login fallito!');
    }
  };

  return (
    <form onSubmit={handleLogin}>
      <input type="text" placeholder="Nome utente" value={username} onChange={e => setUsername(e.target.value)} />
      <input type="password" placeholder="Password" value={password} onChange={e => setPassword(e.target.value)} />
      <button type="submit">Accedi</button>
    </form>
  );
}

function App() {
  return (
    <AuthProvider>
      <h1>Esempio di Autenticazione con Hook Personalizzato & Context</h1>
      <LoginFormForContext />
      <Dashboard />
    </AuthProvider>
  );
}

export default App;

            

              
                Copy
              
            
          

            
// Esempio di AbortController in useFetch (semplificato per chiarezza)
import React, { useState, useEffect } from 'react';

function useFetchAbortable(url) {
  const [data, setData] = useState(null);
  const [error, setError] = useState(null);
  const [loading, setLoading] = useState(true);

  useEffect(() => {
    const abortController = new AbortController();
    const signal = abortController.signal;

    setLoading(true);
    setError(null);

    fetch(url, { signal })
      .then(response => {
        if (!response.ok) throw new Error(response.statusText);
        return response.json();
      })
      .then(setData)
      .catch(err => {
        if (err.name === 'AbortError') {
          console.log('Fetch annullato');
        } else {
          setError(err);
        }
      })
      .finally(() => setLoading(false));

    return () => {
      // Annulla la richiesta di fetch se il componente viene smontato o le dipendenze cambiano
      abortController.abort();
    };
  }, [url]);

  return { data, error, loading };
}

export default useFetchAbortable;

            

              
                Copy
              
            
          

            
// Esempio di test per useCounter (concettuale)
import { renderHook, act } from '@testing-library/react-hooks';
import useCounter from './useCounter';

describe('useCounter', () => {
  it('dovrebbe incrementare il conteggio', () => {
    const { result } = renderHook(() => useCounter(0));

    act(() => {
      result.current.increment();
    });

    expect(result.current.count).toBe(1);
  });

  it('dovrebbe resettare il conteggio al valore iniziale', () => {
    const { result } = renderHook(() => useCounter(5));

    act(() => {
      result.current.increment();
    });
    expect(result.current.count).toBe(6);

    act(() => {
      result.current.reset();
    });
    expect(result.current.count).toBe(5);
  });

  // Altri test per decremento, valore iniziale, ecc.
});

            

              
                Copy
              
            
          

            
// Hook concettuale useLocalizedDate
import { useState, useEffect } from 'react';

function useLocalizedDate(dateString, locale = 'it-IT', options = {}) {
  const [formattedDate, setFormattedDate] = useState('');

  useEffect(() => {
    try {
      const date = new Date(dateString);
      setFormattedDate(date.toLocaleDateString(locale, options));
    } catch (e) {
      console.error('Stringa data non valida fornita a useLocalizedDate:', dateString, e);
      setFormattedDate('Data non valida');
    }
  }, [dateString, locale, JSON.stringify(options)]);

  return formattedDate;
}

// Utilizzo:
// const myDate = useLocalizedDate('2023-10-26T10:00:00Z', 'de-DE', { weekday: 'long', year: 'numeric', month: 'long', day: 'numeric' });
// // myDate sarebbe 'Donnerstag, 26. Oktober 2023'

            

              
                Copy
              
            
          

            
import { useState, useEffect } from 'react';

/**
 * Un hook personalizzato per applicare il debounce a un valore.
 * @param {any} value - Il valore a cui applicare il debounce.
 * @param {number} delay - Il ritardo in millisecondi.
 * @returns {any} Il valore con debounce.
 */
function useDebounce(value, delay) {
  const [debouncedValue, setDebouncedValue] = useState(value);

  useEffect(() => {
    const handler = setTimeout(() => {
      setDebouncedValue(value);
    }, delay);

    return () => {
      clearTimeout(handler);
    };
  }, [value, delay]);

  return debouncedValue;
}

export default useDebounce;

            

              
                Copy
              
            
          

            
import React, { useState } from 'react';
import useDebounce from './useDebounce';

function SearchInput() {
  const [searchTerm, setSearchTerm] = useState('');
  const debouncedSearchTerm = useDebounce(searchTerm, 500); // Ritardo di 500ms

  // Effetto per recuperare i risultati della ricerca basato su debouncedSearchTerm
  useEffect(() => {
    if (debouncedSearchTerm) {
      console.log(`Recupero risultati per: ${debouncedSearchTerm}`);
      // Esegui chiamata API qui
    } else {
      console.log('Termine di ricerca cancellato.');
    }
  }, [debouncedSearchTerm]);

  return (
    <div>
      <input
        type="text"
        placeholder="Cerca..."
        value={searchTerm}
        onChange={(e) => setSearchTerm(e.target.value)}
      />
      <p>Ricerca per: <strong>{debouncedSearchTerm || '...'}</strong></p>
    </div>
  );
}

export default SearchInput;

            

              
                Copy